home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / ramail20.zip / RAMAIL.DOC < prev    next >
Text File  |  1991-02-04  |  16KB  |  353 lines
  1.  
  2.  
  3.  
  4.                                   RAMail DOOR 2.0
  5.                       Copyright 1990, 1991 by Randy Blackmond
  6.                                 All Rights Reserved
  7.  
  8.      Welcome to RAMail, the mail system exclusively for RemoteAccess!
  9.  
  10.      THE DOOR
  11.      --------
  12.      The RAMail Door is only half of the complete system. The other half
  13.      is a reader. You, as a sysop, don't need a reader for your door to 
  14.      function, but your users will so they can read and reply to the mail
  15.      in the packets the door produces. I recommend The Silly Little Mail
  16.      Reader, but Session Manager, Qmail or EZ-Reader will also work.
  17.  
  18.      The RAMail Door accesses MOST of your RA system files. All reasonable 
  19.      precautions have been taken to ensure that RAMail will not damage any of
  20.      these files, but it is recommended that you backup all of your BBS system
  21.      files before running the RAMail Door for the first time.
  22.  
  23.      INSTALLATION
  24.      ------------
  25.      The first thing you need to do is to create a RAMAIL.CFG file by running
  26.      the RAMCONF.EXE program. You must supply the name of the CFG file you wish
  27.      to create/edit on the command line with RAMCONF. If you are upgrading from
  28.      a previous version of RAMail, delete your old RAMAIL.CFG first.
  29.      
  30.      The format of this file is as follows:
  31.  
  32.      SYSOP NAME
  33.      0000000
  34.      BBSCODE
  35.      C:\RA\
  36.      C:\RA\
  37.      C:\UTIL\PKZIP.EXE
  38.      C:\UTIL\PKUNZIP.EXE
  39.      C:\UTIL\DSZ.COM
  40.      1 2 3
  41.      300
  42.      50
  43.      100
  44.      200
  45.      300
  46.      ZIP
  47.      Y
  48.      N
  49.      100
  50.  
  51.  
  52.  
  53.      Line 1 : Your name (sysop's name) goes here.
  54.      Line 2 : Your Registration Number (or 0000000 if unregistered) goes here.
  55.      Line 3 : The codename you wish to use when naming your mail packets. This
  56.               codename should be 8 characters or less in length. It is best to
  57.               use a codename that somehow incorporates the name of your BBS.
  58.      Line 4 : The path to your RA system files, e.g. CONFIG.RA. NOTE the
  59.               trailing backslash.
  60.      Line 5 : If you are running multiple nodes, this line should be the node
  61.               directory with the same format as line 4. If you are not running
  62.               multiple nodes, it should duplicate line 4.
  63.      Line 6 : The path and name of PKZIP.EXE. NOTE the EXE extension IS used.
  64.      Line 7 : The path and name of PKUNZIP.EXE. NOTE the EXE extension IS used.
  65.      Line 8 : The path and name of the DSZ protocol engine. NOTE the extension
  66.               is also included on this filename. You can replace COM with EXE 
  67.               if you use the EXE version. If you don't have the DSZ engine, you
  68.               will have to obtain it to use this door. it is available from
  69.               most BBSes as DSZxxxx.ZIP where xxxx signifies the month and day
  70.               of the version. Try to obtain the latest version.
  71.      Line 9 : Board numbers to force into the users' configurations. Separate
  72.               each board number with a space. If you don't wish to force any
  73.               boards to be configured, leave this line blank or enter a 0.
  74.      Line 10: Maximum number of messages to be "downloaded" locally in 1 run
  75.      Line 11: Maximum number of messages to be downloaded at 300 baud in 1 run
  76.      Line 12: Maximum number of messages to be downloaded at 1200 baud in 1 run
  77.      Line 13: Maximum number of messages to be downloaded at 2400 baud in 1 run
  78.      Line 14: Maximum number of messages to be downloaded at 9600 baud in 1 run
  79.      Line 15: Default extension on your BBS downloadable files.
  80.      Line 16: Enable File Download Function (Y or N)
  81.      Line 17: Enable Hi-Bit ASCII filter for uploaded mail (Y or N)
  82.      Line 18: The security level at which the user can receive any private mail
  83.               regardless of to whom the message is addressed.
  84.  
  85.      There are 3 display files that are included in the QWK packet for the
  86.      offline readers. One is a welcome screen, one is a news screen and the
  87.      third is a goodbye screen. In previous versions of RAMail, the screens
  88.      used were your WELCOME.A*, NEWS.A* and GOODBYE.A* files. In this version,
  89.      your can elect to provide separate screens for the QWK packets. If you
  90.      choose to use this option, the file names you must use are HELLO, INFO
  91.      and BYE for the ASCII version and HELLOG, INFOG and BYEG for the Ansi
  92.      versions. These files, if used, must reside in the same directory as
  93.      RAMail. If these files are not found during packet creation, the BBS
  94.      screens will be used as before.
  95.  
  96.      Code 7 Setup
  97.      ------------
  98.      Put RAMAIL.EXE and RAMAIL.CFG in your RA system directory. The menu entry
  99.      for RAMail should be as follows:
  100.  
  101.      Optional Data: RAMAIL.EXE RAMAIL.CFG
  102.  
  103.      You might want to use RA's swapping to ensure there is enough memory
  104.      for RAMail to run. To do this put *M after RAMAIL.EXE RAMAIL.CFG on
  105.      your Optional Data line, i.e.
  106.  
  107.      Optional Data: RAMAIL.EXE RAMAIL.CFG M*
  108.  
  109.      Code 15 Setup
  110.      -------------
  111.      First, create a directory on your hard drive in which RAMail will reside.
  112.      Place the RAMAIL.EXE program and the RAMAIL.CFG files into that directory.
  113.  
  114.  
  115.  
  116.      Create a batch file like the one below:
  117.  
  118.      @echo off
  119.      cd \RA\RAMAIL
  120.      RAMAIL RAMAIL.CFG
  121.      cd \RA
  122.  
  123.      Note that the name of the CFG file you created is passed to RAMAIL.EXE on
  124.      the command line. Also, ANSI.SYS or some facsimile must be loaded to
  125.      enable you to see the ANSI colors the door uses locally. Loading ANSI.SYS
  126.      is not necessary for successful operation of the door, however.
  127.  
  128.      Place the batch file in your RA directory and add the door to your menu
  129.      the same way you add any level 15 door.
  130.  
  131.      Please realize that the QWK mail packet format is based on the PCBoard
  132.      message standard. What RAMail is basically doing is translating your RA
  133.      messages into PCBoard messages. One annoyance that will probably occur
  134.      is that your board names (referred to as "conferences" in the PCBoard
  135.      world) will be truncated to 10 characters when listed in the readers since
  136.      that is the limit to conference names for PCBoard! You could let your
  137.      RAMail users suffer through this minor annoyance, rename your boards OR
  138.      set up RACONFS.LST.
  139.  
  140.      RAMail will look in the current directory for a file named RACONFS.LST
  141.      to use when inserting conference names into the QWK packet. This allows
  142.      you to retain your 30 character board descriptions in RA and still have
  143.      short, meaningful names for your users' readers! The format of this file
  144.      follows (NO BLANK LINES):
  145.      
  146.      Conf#
  147.      ConfName
  148.      Conf#
  149.      ConfName
  150.      etc...
  151.      
  152.      Example:
  153.      
  154.      1
  155.      Main Board
  156.      2
  157.      Games
  158.      3
  159.      Telecom
  160.      4
  161.      Private
  162.  
  163.      NOTE!
  164.      -----
  165.      The TMUSER.DAT is no longer used in version 2.0 and above. It has been
  166.      replaced with RAUSER.DAT. The included program USRTRANS.EXE will allow
  167.      you to copy the information from your old TMUSER.DAT to the new RAUSER.DAT
  168.      file. This is optional. You can just delete TMUSER.DAT and RAMail will
  169.      create a new RAUSER.DAT upon its first execution.
  170.  
  171.      USAGE
  172.      -----
  173.      The menu for RAMail is straightforward. You have 13 options: Configure,
  174.      Download, Upload, Modify Last Read Pointer, File Areas, Page, System Info,
  175.      Bulletin Toggle, Transfer Protocol, Help, New Files, Quit and Goodbye.
  176.  
  177.  
  178.  
  179.      Configure allows your users to decide which message boards they wish to
  180.      be included in their downloaded mail. It will display all available
  181.      message boards and allow them to pick which ones they want. The config-
  182.      uration the user chooses will be saved in a mini user file maintained by
  183.      RAMail. They can change their configuration at any time. Users will
  184.      not be allowed to choose boards for which they do not have a high enough
  185.      security level and/or a set Read Flag to read. 
  186.  
  187.      The Download option extracts all new mail for the configuration the user
  188.      h